IdenticalText

IdenticalText
Header:	StringCompare.h		Carbon status:	Supported

Compares two text strings for equality, making use of the string comparison information from a resource that you specify as a parameter.

SInt16 IdenticalText (
    const void *aPtr, 
    const void *bPtr, 
    SInt16 aLen, 
    SInt16 bLen, 
    Handle itl2Handle
);

Parameter descriptions

aPtr

A pointer to the first character of the first text string.

bPtr

A pointer to the first character of the second text string.

aLen

The length, in bytes, of the first text string.

bLen

The length, in bytes, of the second text string.

itl2Handle

A handle to a string-manipulation ('itl2') resource that contains string comparison information.

The itl2Handle parameter is used to specify a string-manipulation resource. If the value of this parameter is NULL, IdenticalText makes use of the resource for the current script. The string-manipulation resource includes functions and tables for modifying string comparison and tables for case conversion and stripping of diacritical marks.

function result: 0 if the two text strings are equal; 1 if they are not equal. It compares the strings without regard for secondary sorting order, which means that it ignores diacritical marks and does not distinguish between lowercase and uppercase. For example, if the two text strings are 'Rose' and 'ros√©', IdenticalText considers them equal and returns 0.

DISCUSSION

IdenticalText uses only primary sorting order in its comparison.

SPECIAL CONSIDERATIONS

IdenticalText may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.